home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / Graphics / Anim2qt / JPEG2MOV.readme < prev    next >
Encoding:
Text File  |  1999-01-30  |  6.4 KB  |  235 lines
  1. Short    : Creates a QuickTime-Movie with many JPEGs in it (+GUI)
  2. Uploader : ALeX Kazik <alex@kazik.de>
  3. Author   : ALeX Kazik <alex@kazik.de>
  4. Type     : gfx/conv
  5. Version  : 2.1
  6. Requires : 68020+, AmigaOS 2.04? (Tested: 3.x)
  7.  
  8.  
  9. News:
  10. =====
  11.  
  12. It has an own GUI!
  13. Support of sound and more picture types.
  14.  
  15.  
  16. Overview:
  17. =========
  18.  
  19. This litte tool allows you to create a QT-MOV from many pictures.
  20. You can directly save a MovieShop project to a MOV, for example.
  21.  
  22. All pictures must have the same size.
  23. The pictures will be stored in the MOV without any changes.
  24.  
  25. Supported picture types:
  26. -JPEG, 8bit greyscale
  27. -JPEG, 24bit color
  28. -PNM: pgm, 8bit greyscale, format P5 
  29. -PNM: ppm, 24bit color, format P6
  30.  
  31. Supported sound types:
  32. -AIFF, 1-16bits, 100Hz-65kHz, 1/2 Channels
  33.  
  34. Such movies will be very big, if You're using PNM, or it won't be
  35. playable on the most computers, if You're using JPEG. So just take the
  36. movie, use an (emulated) Macintosh and e.g. the shareware program
  37. "DesktopMovieFat" to recompress the movie!!
  38.  
  39. URL: ftp://ftp.leo.org/pub/comp/os/macintosh/leo/quicktime/desktop-movie-150.sit
  40.  
  41. It is also possible to use QuickTime3 (Registred) on an Mac or PC to Recompress
  42. any Movie. URL: http://quicktime.apple.com/
  43.  
  44.  
  45. Usage:
  46. ======
  47.  
  48. There are two ways to use JPEG2MOV.
  49. -The Command Line Interface (CLI)
  50. -The Graphical User Interface (GUI)
  51.  
  52.  
  53. GUI-Usage:
  54. ==========
  55.  
  56. The GUI requires MUI 3.x (tested 3.8)!
  57.  
  58. Just start JPEG2MOV from WorkBench, or from CLI with "gui" as the only parameter.
  59.  
  60. I hope that the GUI is self explainend.
  61.  
  62. For general help, read the CLI section.
  63.  
  64. The CLI-Version is more powerful!
  65.  
  66.  
  67. CLI-Usage:
  68. ==========
  69.  
  70. JPEG2MOV FROM,TO/A,START/N,MAXFRAMES/K/N,
  71.          SCALEWIDTH=SW/K/N,SCALEHEIGHT=SH/K/N,
  72.          CROPWIDTH=CW/K/N,CROPHEIGHT=CH/K/N,CROPTOP=CT/K/N,CROPLEFT=CL/K/N,
  73.          ORIGFPS=OLDFPS/K/N,FPS=NEWFPS/K/N,SEQUENCE=SEQ/K,TIMESCALE/K/N,SPEED/K/N,
  74.          SOUNDFILE=SND/K,SETFREQ/K/N,
  75.          READALL/S/K,INFO/S
  76.  
  77.  
  78. Required Options:
  79. -----------------
  80.  
  81. TO/A = The movie that should be build. An existing file will be overwitten!
  82.  
  83. And you have to specify video and/or sound.
  84.  
  85.  
  86. Optional Parameters:
  87. --------------------
  88.  
  89. INFO/S = Just show information about the movie, which will be created,
  90.          but don't do it.
  91.  
  92.  
  93. Video:
  94. ======
  95.  
  96. Required Options:
  97. -----------------
  98.  
  99. FROM/A = The path and name of the pictures. There are two methods:
  100.          -Specify an ANSI-C-type-form-string for the pictures,
  101.           e.g. "JP:pic.%04d.jpeg" (only if you know what you do!!)
  102.          -Specify the first picture: e.g. "JP:pic.0012.jpeg", the program
  103.           will automatically convert it to the other format and extract the
  104.           first picure.
  105.  
  106. To specify the speed of the movie (FPS) You have many options.
  107. If the stored pictures have the same speed like the movie, just specify
  108. one of this options:
  109.  
  110. ORIGFPS=OLDFPS/K/N = The FramesPerSecond of the images.
  111. NEWFPS=FPS/K/N = The FramesPerSecond of the movie.
  112. TIMESCALE/K/N,SPEED/K/N = TIMESCALE divides one second into units.
  113.                           SPEED is how long an picture should be displayd
  114.                           (measured in units). Example: TIMESCALE=600,
  115.                           SPEED=10 -> FPS=TIMESCALE/SPEED=60
  116.  
  117. If the original and the new FPS-rates are different, You have some
  118. methods to do that.
  119. The skipped pictures won't be stored in the movie.
  120.  
  121. SEQUENCE=SEQ/K = An text which specifies, which picture should be picked "P"
  122.                  (stored in the movie) or skipped "S".
  123.  
  124. Now You can do some combinations:
  125. -ORIGFPS and NEWFPS
  126. -ORIGFPS and SEQUENCE
  127. -NEWFPS and SEQUENCE
  128. -TIMESCALE+SPEED and SEQUENCE
  129.  
  130. Tip: switch on INFO an play a little bit with this options.
  131.  
  132.  
  133. Optional Parameters:
  134. --------------------
  135.  
  136. START/N = Specifies the first picture. It defaults to the number, which will
  137.           be extracted from the FROM-Option - if there is a number in it -
  138.           or 1.
  139.  
  140. MAXFRAMES/K/N = Maximum numbers of frames to read/skip. (If Your orig and new
  141.                 FPS-Rate are equal, this means also the numbers of written frames)
  142.  
  143. READALL/S/K = Force to read all pictures, even if there skipped.
  144.               This option is essential, if you've stored the pics a PIPE
  145.               and only want to read some of the pictures.
  146.               
  147. Note: If some programms (e.g. MovieShop) don't allow to store to PIPE: (cause
  148.       it's no filesystem), get the "PipeHandler.lha" from AmiNet.
  149.  
  150.  
  151. Scale / Crop-Options:
  152. ---------------------
  153.  
  154. The program does NOT change the JPEGs, it will only set the needed options
  155. in the movie, that tell good QT-Programs that the movie should be shown
  156. scaled/cropped.
  157. QT and CyberQT do not support them at all. The Windows QT-Player supports
  158. scaling.
  159. All Mac programs support both!
  160.  
  161. SCALEWIDTH=SW/K/N,SCALEHEIGHT=SH/K/N = The size of the scaled picture.
  162.                                        (default: original picture)
  163.  
  164. The picture will be first scaled, than cropped.
  165.  
  166. CROPWIDTH=CW/K/N,CROPHEIGHT=CH/K/N = The size of the cropped picture.
  167.                                      (default: scaled picture)
  168.  
  169. CROPTOP=CT/K/N,CROPLEFT=CL/K/N = The offset to the left-top-edge of the
  170.                                  cropped picture. (default: the picture will
  171.                                  be centered)
  172.  
  173.  
  174. Audio:
  175. ======
  176.  
  177. Required Options:
  178. -----------------
  179.  
  180. SOUNDFILE=SND/K = The soundfile.
  181.  
  182.  
  183. Optional Parameters:
  184. --------------------
  185.  
  186. SETFREQ/K/N = If Your soundfile e.g. have the frequency 40099 but You're knowing
  187.               that that is an error, You can change the rate with this option to
  188.               44100 (or any other freq.).
  189.  
  190.         Note: The sample will not be resampled, only the signature will be changed.
  191.  
  192.  
  193. Thats all, have fun!!
  194.  
  195.  
  196. History:
  197. ========
  198.  
  199. Version 2.1 (30.01.98)
  200. - Bugfix: CLI: MAXFRAMES
  201. - Made the CLI-Output more readable
  202.  
  203. Version 2.0 (26.12.98)
  204. - GUI
  205.  
  206. Version 1.9 (22.11.98)
  207. - Sound support
  208. - PNM support
  209.  
  210. Version 1.0 (29.09.98)
  211. - First release
  212.  
  213.  
  214. Author:
  215. =======
  216.  
  217.  
  218.                         ALeX  Kazik
  219.                     Stapenhorststr.  81
  220.                       33615 Bielefeld
  221.                           Germany
  222.  
  223.                    E-Mail: alex@kazik.de
  224.             HomePage:  http://www.kazik.de/alex
  225.  
  226.  
  227.  
  228.  
  229.  
  230.                                                 ###### ##      ####  ##   ##
  231.                                                ##   ## ##     ##  ##  ## ##
  232.                                                #### ## ##     ######   ###
  233.                                                ## #### ##     ##      ## ##
  234.                                                ##   ## ######  ####  ##   ##
  235.